home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / dorpch37.arc / README.NOW < prev    next >
Text File  |  1991-01-01  |  5KB  |  99 lines
  1.  
  2.      January, 1, 1991    IMPORTANT - PLEASE READ
  3.  
  4.  
  5.      For a description of changes in this release see CHANGES.DOC
  6.  
  7.      Big problems: QuickBASIC 4.0 cannot be used.
  8.                    Please read our comments in the DOC regarding
  9.                    our choice of QuickBASIC 3.0.  We are, however,
  10.                    working on routines that may lead to the
  11.                    capability to use QuickBASIC 4.x.  No promises!
  12.  
  13.      The files contained herein work with QuickBASIC 3.0 only.
  14.  
  15.      I've included a file: CLE.BAT for compiling and linking the example door.
  16.  
  17.      This is Release 3.7 of DOORPCH.  It is a complete replacement for
  18.      any previous version in your possession.  The previous version was 3.5.
  19.  
  20.      You will require Microsoft (R) QuickBASIC 3.0 compiler to use
  21.      DOORPCH 3.7.  All the necessary files are contained within this ZIP file
  22.      and should ALWAYS be distributed together as a unit.
  23.  
  24.      Many hours of hard work have gone into this release.  The logic contained
  25.      herein came from Raymond Clements, Clint Labarthe, Terry Shockley,
  26.      Harold Thompson, and Ben Perron.
  27.  
  28.      If you haven't ever written a DOOR before then read on in the DOCS and see
  29.      just how easy it is!  We have even provided an example DOOR program
  30.      demonstrating just a few of the capabilities of DOORPCH 3.7.  For those of
  31.      you that are upgrading, we have provided you upward compatibility - more
  32.      or less.  Most all the functions continue to work.  The GETIN2.ASC code has
  33.      been replaced in a small part by DOORPCH.END.  The majority and all new
  34.      code is in DORPCH37.EXE which is now used by the QB compiler during
  35.      compilation.  A LINKER.BAT file is provided for you to LINK your program
  36.      (.OBJ) into an executable module (.EXE).
  37.  
  38.      You may have to patch your BRUN30.EXE file.  Included are instructions
  39.      on how to do this.  If you require a version and/or feel uncomfortable
  40.      modifying yours, then call one of our BBS's and download it.  Either
  41.      include the patched BRUN30.EXE with each of your DOORS or provide a way
  42.      for other SysOps to download the patched version.
  43.  
  44.      Please read ALL the DOCS before proceeding.  Much has changed.
  45.      Functionality abounds.  You really owe it to yourself (and me too!) to
  46.      read thru this.  If you have any questions, call my BBS and ask for
  47.      assistance.  If a bug is detected, please let me know right away.
  48.  
  49.      NOTE: Six IMPORTANT new things.......
  50.  
  51.       1)   In your batch files, you MUST now remove the /NETWORK
  52.            parameter if it currently exists.  It is no longer
  53.            needed/supported.
  54.            Failure to do this will result in a run-time error.
  55.  
  56.       2)   Also - AND VERY IMPORTANT -
  57.                   A NEW variable has been added which MUST be set BEFORE
  58.                   the INCLUDE for DOORPCH.BEG.  It is NODE%.
  59.                   If your program uses disk data files that must be
  60.                   shared AND you have file locking logic then set
  61.                   NODE% = 1.
  62.                   If you DO NOT have disk data files then set NODE% = 1.
  63.                   If you DO have disk data files AND DO NOT have
  64.                   file locking logic then set NODE% = 0.  This variable
  65.                   when set to equal to <1> will allow the DOOR to run
  66.                   on multiple nodes concurrently.  If this variable is
  67.                   found set to zero, then DOORPCH will only allow it to
  68.                   run on ONE NODE CONCURRENTLY.  Please BE CAREFUL.
  69.  
  70.       3)  On existing DOORNAME.CFn files used by DOORS LINKed to version
  71.           3.4 of DOORPCH, you MUST delete the first record - COM1 or
  72.           COM2.  This information is obtained from the BBS files by
  73.           DOORPCH.
  74.  
  75.       4)  The PROGNAME$ and R.ELEASE$ strings MUST be populated BEFORE
  76.           entering the logic in DOORPCH.BEG.  They should be populated
  77.           with your DOOR name and release version respectively.
  78.           (ie. PROGNAME$ = "4 Card Solitare": R.ELEASE$ = "v1.5").
  79.  
  80.       5)  The PROGB$ string MUST be populated BEFORE entering the
  81.           logic in DOORPCH.BEG.  It should be populated with the
  82.           BATCH (or PROGRAM) name. (ie. PROGB$ = "4CARD")
  83.  
  84.       6)  You MUST set two variables in AUTOEXEC.BAT for your BBS system.
  85.           Place the following statements any place in AUTOEXEC.BAT:
  86.                         SET DOORPCH=PCB (for prior DoorPch compatibility)
  87.                         SET LIB=<path to DORPCH37.EXE>
  88.  
  89.      If you get an error during the DOORPCH initialization process it
  90.      is probably due to an incorrectly configured .CFG file or the
  91.      parameter passed to your door (ie. 4CARD 4CARD.CFG) is probably
  92.      incorrect.  It may be due to one of the six things listed above.
  93.  
  94.      Thanks,
  95.  
  96.      Raymond Clements - The Pegasus BBS - (502)684-9855 or (502)684-9871 HST
  97.  
  98.  
  99.